Copyright: ® Steven Buck


Help Contents
 VC Clean!

Introduction to VC Clean!

Cleanup Projects

Adding VC Clean! to the Visual Workbench

Files Removed by VC Clean!

Project Target

Project Files

Compiler and Link Files

Visual Workbench and App Studio

Registration

What is Shareware?

Disclaimer

Registration Information

Registration Form

Support


Cleanup Projects

VC Clean! provides a quick and easy way to cleanup the files generated during a build using Microsoft's Visual Workbench and Visual C++.  For example, you might want to recover all of the disk space taken up by a build of a Visual C++ example project once you no longer need the executable.

The files generated during a build can be very large and you can end up with alot of disk space dedicated to files you no longer want.  You might want to keep a project for future reference, saving the source and project files required to build the project, but without the overhead of the files created during the build.  Use VC Clean! to remove all of the unneccessary files.


Adding VC Clean! to the Visual Workbench

Microsoft's Visual Workbench can be customized to allow you to add tools to the Tools menu on the menu bar.  Once you have added VC Clean! to the Tools menu, you can invoked VC Clean! to remove the files generated during compilation of a project.

Go to the Options menu item in the Virual Workbench and select the Tools menu item.  Tools will bring up a dialog box that will allow you to add VC Clean!.

1.	Press the Add button to create the entry for VC Clean!.  From the file dialog box, find vcclean.exe, and select it.  Press OK.  This will place the pathname for VC Clean! into Command Line.

2.	Change Menu Text to VC Clean!

3.	Set Arguments as shown below.  The $Proj argument provides the name of the current project to VC Clean!.  $ProjDir provides the fully qualified project pathname for the current project.  And $Target provides the fully qualified pathname of the file created by the project.  $Target could be an executable file, library, or DLL.

$Proj $ProjDir $Target

4.	Press OK to save this entry.

Now when you select Tools from the Visual Workbench menu bar you will have a menu item VC Clean! on that menu.   Selecting that item will run VC Clean! with the three arguments defined by you when you added VC Clean! to Tools.


Project Target

The project target file is the file created if a build of your project successfully completes.  The most common targets are executable files (*.EXE), libraries (*.LIB), or dynamic link libraries (*.DLL).

The default is to leave the project target file.


Project Files

Class Wizard (*.clw)

Browser Database (*.bsc)

Program Database (*.pdb)

Precompiled Header (*.pch)

Compiled Resources (*.res)


Class Wizard (*.clw)

The Class Wizard creates a database with a .CLW extension.  This database contains the information about the class you've created in your project.

The default is to leave the Class Wizard database.  However, if you delete this file, you can recreate it by going to the Class Wizard menu item under the Resource menu in the App Studio.  A dialog box will pop up to allow you to recreate the database.  Just press OK, and App Studio rebuilds the file.


Browser Database (*.bsc)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Program Database (*.pdb)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Precompiled Header (*.pch)

There is normally only one precompiled header file in a project directory.  This file contains a special binary form of all of the headers precompiled as part of the specified header file.  The project default created using AppWizard is a file call stdafx.pch.

This file will be recreated during the next build after you've deleted it with VC Clean!.


Compiled Resources (*.res)

The resource compiler creates a file with the .RES extension when it compiles your project's .RC files.  This file is then incorporated into your project target file.

This file will be recreated during the next build after you've deleted it with VC Clean!


Compiler and Link Files

Object Files (*.obj)

Source Browser Files (*.sbr)

Assembler Listings (*.cod)

Linker Maps (*.map)


Object Files (*.obj)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Source Browser Files (*.sbr)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Assembler Listings (*.cod)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Linker Maps (*.map)

This file will be recreated during the next build after you've deleted it with VC Clean!.


Visual Workbench and App Studio

Visual Workbench (*.vcw)

Workspace (*.wsp)

App Studio (*.aps)


Visual Workbench (*.vcw)

This file will be recreated the next time that you enter or exit the Visual Workbench.


Workspace (*.wsp)

Files with the extension .WSP contain window layout information for the Visual Workbench.


App Studio (*.aps)

The file with the .APS extension contains information about the status of the App Studio.  It will be recreated during the next App Studio session.


What is Shareware?

Shareware distribution gives users a chance to try software before buying it. If you try a Shareware program and continue using it, you are expected to register. Individual programs differ on details -- some request registration while others require it, some specify a maximum trial period. With registration, you get anything from the simple right to continue using the software to an updated program with printed manual.

Copyright laws apply to both Shareware and commercial software, and the copyright holder retains all rights, with a few specific exceptions as stated below. Shareware authors are accomplished programmers, just like commercial authors, and the programs are of comparable quality. (In both cases, there are good programs and bad ones!) The main difference is in the method of distribution. The author specifically grants the right to copy and distribute the software, either to all and sundry or to a specific group. For example, some authors require written permission before a commercial disk vendor may copy their Shareware.

Shareware is a distribution method, not a type of software. You should find software that suits your needs and pocketbook, whether it's commercial or Shareware. The Shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee -- if you don't use the product, you don't pay for it.


Disclaimer

Users of VC Clean! must accept this disclaimer of warranty:

VC Clean! is supplied as is.  The author disclaims all warranties, expressed or implied, including, without limitation, the warranties of merchantability and of fitness for any purpose. The author assumes no liability for damages, direct or consequential, which may result from the use of VC Clean!.


Registration Information

VC Clean! is a "shareware program" and is provided at no charge to the user for evaluation.  Feel free to share it with your friends, but please do not give it away altered or as part of another system.  The essence of "user-supported" software is to provide personal computer users with quality software without high prices, and yet to provide incentive for programmers to continue to develop new products.  If you find this program useful and find that you are using VC Clean! and continue to use VC Clean! after a reasonable trial period, you must make a registration payment of $9.95 to AdMation.  The $9.95 registration fee will license one copy for use on any one computer at any one time.

You must treat this software just like a book.  An example is that this software may be used by any number of people and may be freely moved from one computer location to another, so long as there is no possibility of it being used at one location while it's being used at another. Just as a book cannot be read by two different persons at the same time.

Commercial users of VC Clean! must register and pay for their copies of VC Clean! within 30 days of first use or their license is withdrawn.  Site-License arrangements may be made by contacting AdMation.

Anyone distributing VC Clean! for any kind of remuneration must first contact AdMation at the address below for authorization. This authorization will be automatically granted to distributors recognized by the (ASP) as adhering to its guidelines for shareware distributors, and such distributors may begin offering VC Clean! immediately (However AdMation must still be advised so that the distributor can be kept up-to-date with the latest version of VC Clean!.).

You are encouraged to pass a copy of VC Clean! along to your friends for evaluation.  Please encourage them to register their copy if they find that they can use it.  All registered users will receive a copy of the latest version of the VC Clean! system.


Registration Form

AdMation Order Form

Qty		Price	Total
	Copies of VC Clean! Version 1.0	$9.95
	Unlimited site license for VC Clean! Version 1.0	$195.00
	Colorado Residents add 7.0% sales tax
	Total
Name:

Company:

Address:

City:                                                     State:                   Zip:

Where did you obtain your copy of VC Clean!?

Mail with payment to:

AdMation

P.O. Box 260613

Highlands Ranch, CO      80126-0613

Please allow 3 weeks for processing.


Support

Support for VC Clean! is available by writing AdMation or electronic mail from on the CompuServe Network.   Any registered user is eligible for support.  Problem reports and suggestions are welcome from unregistered users.  Contract AdMation through CompuServe id:  70233,1364 or through the mail at

AdMation

P.O. Box 260613

Highlands Ranch, CO  80126-0613